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v03-001 MMD0001 ro Ay 30-Jun-1982 9:26 
Add field in GF def's to ro user to set time when to 


deselect the station. 


> FACILITY: Software DDCMP 

> ABSTRACT: Definitions required for driver to DDCMP interface. 

> AUTHOR: M. M. Dumont CREATION DATE: 1-Apr-1981 

> Modified by: 

; V03-004 mMD0292 Meg Dum 23-Apr-1984 14:55 

; Add some fields to Nt yy tik the retransmit out of order problems 
: VO3-003 MMD0206 Meg Dum 8-Dec-1983 12:56 

3 Changes to support BISYNC “Speration over the Sars and 

: changes to support ASYCNH DDC 

; VO3-002 mMD0169 Meg Dumont, 35-May-1983 12:52 

; Add ppece for the address of the device timer routine in 

3 the TF block. Add DLK codes for timer startup and shutdown. 
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+ 
; DOCMPDEF = Global constant definitions for DDCMP 


FILL character 

Protocol in halted state 

Station addr for all cntrl stations 
Protocol in eyanene ztete 

Protocol in start initiate state 
Protocol in start acknowledge state 
Protocol in maintenane mode 

Six bytes of DDCMP header 

Max number of msgs allowed on queues 
Size in bits of a byte 


a 


——————_-— 
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3¢ 
; MFD = Message field definitions for DDCMP data and maintenance message 
: headers and for control messages. 


SSTRUCT MFD 
MSGID 


F 8 ; Message Identifier. 
F CNTFLG,W ; Field containing count and flag 
3; information for headers. 
Vv < 
214 ; 14 bits of count or a byte ENQ type 
; and 6 bits of NAK type 
QSYNC,1,.— ; Receiver should expect a short syn. 
SELECT, 4; .™ 3; For halp duplex Links only, receiver 
; becomes transmitter and visa versa. 
> 
Ss TYPFLG,O,W 3; Field containing type and flag info 
, - ; for control messages. 
SUBTYP,0 ; Start of NAK sub type field 
SUBTYPL ,6 3; Length of NAK sub type field 
> ; Use bits in original definition. 
‘ RESP .B ; Resp number of last correctly RCV'd 
3 message for piggybacked ACK's. 
F NUMB ,B ; Transmit number of data message. 
‘ ADDR ,B 3; Station addr, 1 for point-to-point. 
: LENGTH ; Length of MSG (8 bytes of header). 


gameebeelome o. 


i 
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ge 
; KMTQ = Queue entry for transmits appended to top of buffer. 


SSTRUCT XMTQ 


nn i Be es ee Be | 


TIMEND,L 


F BACC,L 


; The next two fields must be in the same 


MSGOFF ,W 
mscsiZE 


SLO 
RROR ,W 


E 
FLAG,B 
<m 


<a 


ONQUEUE...M 
SELECT,,.™ 
CONTROL,,.M 
INTERNAL,..M 


> 
HCRC Wd 


DCRC WwW 
MSGHDR .B,6 
LENGTH 


ca> 7 


The foward and backward Links 
Length of the buffer 

Type of buffer 

Spare Could be used for Fork IPL 
Address of phe IRP asscociated with 
this transmit 

Time that the XMT‘'d messace is 
sheduled to reply timeout only used 
when the stattion uses a real clock 
to time reply timeouts 

Buffer address and character count 


order as IRP$W_BOFF AND BCNT 


Offset from PTE to msg start 

Size of msg including header 

Store vector slot used for transmit 
Device error status for XMT 

Flag for ENQ messages 


Flag set when cntl msg is on a queue 
Set by protcol if select flag is set 

in message to be sent 

Set when the msg sent is a cntrl msg 

Reserved 

When set then the IRP was not issued 

via Q10, but by an internal method 


Header CRC for devices which don't 
ei roedy support CRC 

Data CRC 

Space for the message header 


| DDCMPDEF MDL; 1 


| 
| SSTRUCT TF 
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3 Longwords of header 


iy HOR,L,3 3 
; Notice default for €HAR is Full duplex control station on a sync Line 


<7" 


es ee ee ee) 


RADOR ,B 
XQCNT,B 


; Message exchange fields 


Sa lena line nalna) 


; Timers 


ey 


bs ee | ie ie ee | 


R,B 
A.8 
1.8 
x58 
SELTIM,B 
cs 
SELECT,,.M 
OWNSELT 


one 


TIMER, ,.m 
RCVDET...™ 


NEXT,,.M 
> 


MMACTR,B 
TEB,W 


; Device characteristics 


= Control 12T 
= Point to point 12. 
= Full duplex 12H 
Station address, default is 
XMT station address default is 1 
RCV stattion address default is 1 
Count of number of free slots on XMTQ 


ee on" oo ae 


Highest sequential msg RCV'd 
Highest sequential msg XMT'd 
Highest sequentia: msg ACK'd 
Next data msg to XMT 

Last data msg to be XMT'd 


Selection and timer flags 


When set then send the select flag 
When set we own the select flag 

If set then the timer is running 
Set when a msg is rcv'd used to 
determine if a seletion has been 
acknowledged in some way 

Send the ACK next clock tick 


Type of reply timer 

Amount of time to wait before timing 
the reply timer out. This field is 
only used for timing via a real clock 
Max number of reply timeouts allowed 
Current number of reply timeouts 

Max number of messages allowed to 
send in one selection interval 
Counter of these msgs 

Size of counters block 


; These fields must appear in the folllowing order and offset because the 
; dirver expects to find the different protocols XMT and Complete queues 


ee ee Be Be] 


in the same place. 


List head for the control message Q 
List head for the CMPQ 
List head for the XMTQ 
List head for the RTOQ 


BeBe Oe Oe Be Be Be Be Se Se Se Be Be Se Se Se Se Se Se Se Be Se Se Se Se Se Se Se Oe Se Se Se Se Se SHS Se Se BH Se Se Be Se OH Se Oe oe oe 
a 
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| 
| 
| 


3; These 


<a"Tss" ee es Dee ee os an"awh aw" 


ln Bie Be Be Bee Bee Be Bee Bs Be Bn Bn) 


<a" 


<a 


NPR ,A 


QACK,L,1 
QNAK,L,1 


we 
asTrf,L,12 


QSTACK,L,12 


IDCRC,..M 
IREPS,,.m 
> 

DEI,8 
LBETYP,w 
LBEBC,W 
<M 


IMER,A 
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List head for the XMT overflow queue 
This field gets the value of 

RB on entry to the protocol 

Address of the global field block 
Address of device timer routine 
Address of drivers inprogess List 
Address of drivers post queue 


jelds must be at least as long as the XMTQ plus six bytes 


Queue block for an ACK message 
Queue block for an NAK message 
Queue block for an REP message 
Queue block for an STRT message 
Queue block for an STACK message 


Timer queue entry block 
NAK reason code 
Send an ENQ message flags 


Send a NAK 
Send an ACK 
Send a REP 


Se Ge Ge Sete Ge 


Start of error counters 

NMA definition for the field 
Records bytes RCV'd by station 
NMA definition for the field 


Records msgs RCV'd by station 
NMA definition for the 
Records msgs XMT‘'d by station 
NMA definition for the 

eceres selection intvls elasped 


def for field 
Data errors outbound bit counters 


NAK's RCV'd header CRC reason code 1 
NAK's RCV'd data CRC reason code 2 
NAK's RCV'd REP response rsn code 3 


Data errors outbound 
def for fie 
Data errors inbound bit counters 


NAK's XMT'd header CRC reason code 1 
NAK's XMT'd data CRC reason code 2 
NAK's XMT'd REP response rsn code 3 


Data error inbound 
NMA definition for the field 
Local buffer error bit counters 


Sete Ge Sete Ge 


—————_—_————___— 
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LBUF _LNAVL,,.M 
| LBUF “SAL. 
j 


LBE.B 
RBETYP,w 
RBEBC ,W 
<n 


RBUF_NAVL,,.M 
RBUF~SML,,.M 
> 


<a 


RBE.B 
STOTYP.W 
STOBC, 


<M 
NOREP SEL... 
INCREP_SEL,,.M 


$T0,8 
LRTOTYP,w 
LRTO,8 
RRTOTYP,W 
RRTO, 


ERREND 
THRES ,W 


8 
LENGTH 


en 


EE 
7 - ATA <a 
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Local buffer unavl SNAK set rsn 8 
Local bfr too small SNAK set rsn 16 


Local buffer error 
NMA definition for the field 
Remote buffer error bit counters 


Remote buffer unavl NAK RCV'd rsn 8 
Remote bfr too small NAK RCV'd rsn 16 


Remote buffer error 
NMA definition for field 
Selection timeout bit counters 


When no attempt to respond was made 
When attempt is made but the timeout 
still occurs 


Selection timeout 

NMA definition for field 

Records setting of SREP 

NMA definition for field 

Records setting SACK when REP RCV'd 
with NUMB = R 

End of error counters 


; Threshold errors 


Bits ¢ RCV threshold errors 

Bits 3-5 XMT threshold errors 

Bits 6-8 Selection threshold errors 
Reserved 


> 


| 
_DDCMPDEF .MDL;1 


| 

| SSTRUCT GF 
F STATE.B 

: TIMER STATE,B 

Vv <4 
TIMER_RUNNING, ,.M 

DRVCHR,B 

<4 

CRC 

SELWAI.W 

NEXTCNT,W 


MAXSEL .B 
CURSEL,B 


<" 


L 
TOE STS.L 
STRTIM,B 


BABTIM,B 


STRTMR,L 
BABTMR,L 


error counters 
ER 


LSETYP,W 
LSE_BCTRS.wW 
om 


R° A.) 


Ove; mM 
LXMT_ONDER..,M 
LMSGRDR, FMT... 


Ss Ie Be Hn 4 Ton. Bena Tena Pensa, Bn.a Iona, Bon. Bn a Bion) 
< 


3; Stati 


<~-~r8 
PJ 
un” 
po) 
a 


LSE,B8 
RSETYP,w 
RSE_BCTRS.W 
<A 


<a 


MOF CRC,B 
STRTSEL.B 
LENGTH 


cases 
7) 
= 
oO 
b+) 
oO 
@w 
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State of protocol 
State of DDCMP timer 


Timer is currently running = 1 
Timer stopped = 
Device charateristics 


0 = Device does CRC checking 


Amount of time to wait before timing 
the selection interval out 

Count on which interval the station 
will deselect itself in trib mode 

Max number of selection intervals 
Current number of selection intervals 
Fork IPL of driver 

Device IPL from driver 

Size of global counter block 

Time the selection int expires 

Return status of timeout 

Amount of time to wait before setting 
station streaming tla 

Amount of time to wait before setting 
station babbling flag 

Stream timer 

Babbling timer 


Start of error counters 
NMA definition for the field 
Local station errors bit counters 


Receive overrun SNAK set reason 9 
Receive overrun SNAK not set 

XMT underrun 

NAK RCV‘'d reason code 17 


Local station errors 
NMA definition for the field 
Remote station errors bit counters 


NAK's RCV'd reason code 9 
SNAK set reason code 1 : 
Message RCV'd by an unselected trib 
Streaming trib 


Remote station errors 

End of error block 

Global header CRC error 

Maintenance data field CRC error 
Maxium selection cimeouts on startup 
GF block length 


Seee Se Ge Ge Se ee Se Se Se Se ee Se Se Se Se Se ae 


————_____- —-—_--_——_ hae cmsnsianeensat cneancintvenfaniats 
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-+ 


: The following definitions are commands used to interface the driver 
; and the protoco 


pene DLK 
reves ; Message was received 


XMTMSG Message to ence) 
REQEBA User requests a trib'’s error block 
i User initiated commands 


Set up Line characteristics 
Start DDCMP timer 
Stop DDCMP timer 


CHA 
START_TIMER 
STOP_TIMER 
RETIRFO 


ETIN 
ACTNOTCOM 
| 


Return action status to driver 
Action that the driver requested 
of the protocol could not be 

. completed 


; The following are bit definitions for each code associated with the 
; various commands. 


; INTERFACE DDCMP TO DRIVER 


3 geeeeceeereererereeraererene 


: Bit codes for DLKSC_RETINFO 


Vv <A" 
TRNSERR,, ; Transient error threshold overflow 
PRSTERR,,, ; Persistent errors 
REINT,., ; Reinitialize the protocol 
HDRERR.. ; Error in header 
XMTERR,,, ; The data msg to XMT contained no data 
OFULERR..,M ; The XMTQ is full >12 Sutstanding msg 
STRTRCV,,.— 3; The protocol RCV'd a STRT while in 
MNTRCV,,,— ; Maint msg rcvd while in HLT or RUN 
; RUN state 

RCVACK,..™ 3; A receive message was acknowledged 
XMTACK,,.M ; A transmit message was ACK'd 
XMATCMP,,,M ; An XMT is done and ready to post 
SNSYN,,,M ; 0 = send lng sync 1 = send short sync 
ENTANT..,M ; The protocol has entered maint mode 
ERROR,, .# ; Address of error block requested 

3 from trib 

TRNLK,,.M ; Inform driver to stop RCVing and 

3 start XMTin 

TMREXPD,,.™ 3; Set if TQOE_STS when the DOCMP timer 

| 3; has expired. For half duplex and 

; multipoint the msg must be send . 

| CRC,,.m : Receive buffer CRC error do not comp 


DDCMPDEF .MDL; 1 


o 


(Bit codes for DLKSC_ACTNOTCOM 


<* 
BADSTATE,,.™ 


BADACTION,,.™ 
CMDERR,,.m 


RCVERR,,.M 


27 
> 


eeeeeeeereerrerrerarererenre 


INTERFACE DRIVER TO DDCMP 


eeeeeerereeerrererereraere 


Bit codes for DLKSC_RCVMSG 
Vv 


PADBYTE..,™ 
6 


; Bit codes for DLKSC_XMTMSG 


v <4 
MSGSENT,,,™ 


QEMPTY,,.m 
"3 
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Protocol was in the worng state 
for action 

Action was ambigous 

Command was not recognized or 
expected 

Rcv msg contained a code which was 
not recognized by the protocol 
reserved 


Link was lost 

Header CRC error 

Data CRC error, hdr CRC was ok 
Buffer was not available 

RCV buffer was to small 

RCV overrun 

No PAD byte on a RCV msg 
reserved 


Message has beent XMT'd it may need 
to be reply timed out 
Indicate to driver the XMTQ is empty 


; reserved 


Bit codes for DLKSC_REQEBA interface driver to DDCMP 


¥ 


Bit codes for DLKSC_USRINT interface 


Read and clear the counters 
Return trib counters 
Return gate counters 
Reserve 


driver to DDCMP 


——____—_ 
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| 
| 
Vv <4 
START, ,.M 
STOP, .. 
mal pat 
2 


H 1 
16-SEP-1984 16:37:58.98 Page 12 


; Start protoc 


ol 


; Stop protocol 
; Enter maintenance message 


; Bit codes for DLKSC_CHAR interface driver to DDCMP 


a 


ABBLE.,..M 
SETOEr 400M 


; Struct of parameter buffer 


REPWAIT,W 
SELWAIT 


"3° 


n RAAT Aa 


; necessary dr 


SSTRUCT DLA 

£ XMT_INPR,A 
f STQ,A 

t ADDR_LENGTH 


= control 


= full dup 
= device d 
f set user 
f set user 
f set user 
f set user 
f set user 
f set user 
f set user 
et default 


0 
0 
0 
0 
I 
I 
I 
I 
I 
I 
I 
S 


Trib address 


Reply timer 


Two spare by 


er address to the protocol. 


= point to point 


lex 
oes 


cre 


12tr 
1 = mu 
1 = ha 
1 = de 


ibutary 

Ltipoint 

Lf duplex 

vice ae no crc 


set msgs/selection inty 
# of selecton intvl 
selection intvl wait 
& of reply 1/0 
reply 1/0 tries 
streaming time 
babbling time 


set 
set 
set 
set 
set 


set 
DDCM 


wait 


tes 


P values 


field 


Select timer wait field 
Maintenance mode 
Maxium receive buffers 


: The fol lowing definitions are the buffer definitions used to pass 
e Vv 


Number of msgs to send / selection 
Number of retries on reply T/0 
NUmber of retries on select 1/0 


; Address of the drivers xmt inprogress 
; Address of the drivers post queue 


DEE RSE ¢ ARTIC Rete Se RES TRIS dN ae Re ON ached ene SSR eee eee 
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